home *** CD-ROM | disk | FTP | other *** search
/ Disc to the Future 2 / Disc to the Future Part II Programmer's Reference (Wayzata Technology)(6013)(1992).bin / MAC / THINKC / 5 / XCSHELL / READ_ME!.!!_ < prev    next >
Text File  |  1991-08-31  |  5KB  |  128 lines
  1. The enclosed source code is shareware, that is "user supported software".  It is
  2. provided for use by developers in the interest of generating Hypercard XCMDs and
  3. XFCNs using Think C 5.0.  If you find it usefull, please send me $20 to encourage
  4. the publication of additional source code products distributed in the same way
  5. accross the networks (I own a lot of stuff I could make available if sufficiently
  6. motivated).  I will answer any inquiries made and if necessary fix any bugs found
  7. in the original sources in this package.
  8.  
  9.  
  10.     Mark M. Owen
  11.  
  12.     AppleLink:    D4900
  13.     GEnie:        M.OPTIONS
  14.     Compuserve:    71530,2232
  15.     Voice:        206-868-5418
  16.     USPS:        Box 95167 Seattle WA 98145-2167
  17.  
  18. =====================================================================================
  19.  
  20. Required Modifications:
  21. =======================
  22.     XCMDconstants.h:
  23.         add your new verbs to the verbs enumeration;
  24.         add any new errors to the errors enumeration;
  25.         
  26.         resource definitions:
  27.             GLOBALTYPE    use a unique resource type;
  28.             GLOBALS        use an unique name;
  29.             VERBS        use an unique name;
  30.             NPARAMS        use an unique name;
  31.             ERRORTAG    use an unique name;
  32.             ERRORS        use an unique name;
  33.             
  34.     XCMD.rsrc resource file items ( name/type ):
  35.         VERBS/STR#        change name and add new verb strings;
  36.         NPARAMS/vrpm    change name and add param counts for new verbs (in order);
  37.         ERRORS/STR#        change name and add any new error messages;
  38.         ERRORTAG/STR    change name and error prefix (optional);
  39.         
  40.     XCMDglobals.h:
  41.         add any globals data items to globals structure;
  42.         
  43.     XCMDglobals.c:
  44.         SaveGlobals to save your global data between calls before XCMD exits;
  45.         RestoreGlobals to restore XCMD global values from previous call;
  46.         
  47.     XCMDversion.c:
  48.         definition of VERSION for copyright, etc.
  49.         definition of _MC68881_ for suffix
  50.  
  51. The places where modifications are expected are clearly identified with a banner
  52. similar to the following:
  53.     ///////////////////////////////////////////////////////
  54.     ///        make changes here because they are needed    ///
  55.     ///////////////////////////////////////////////////////
  56.  
  57.  
  58. Project File Contents:
  59. ======================
  60.     ╡soANSI-A4 or ╡soANSI881-A4
  61.     HyperXLib
  62.     MacTraps
  63.     main.c
  64.     SysEnvirons.╣
  65.     XCMDutils.c
  66.     XCMDglobals.c
  67.     XCMDversion.c
  68.  
  69. If you use the project file supplied as a template, your XCMD will be configured
  70. to run on any Mac; with multiple segments if needed.  
  71.  
  72. The sample stack and resource file are merely to illiustrate the XCMD shell's 
  73. functions: Version and Dispose.
  74.  
  75. After you have compiled your XCMD and merged it with the modified resources, you
  76. should ResEdit or equivalent to copy the entire contents of the XCMD.rsrc file to
  77. the destination stack.  If the destination stack has another XCMD installed which
  78. has the same number as your XCMD, you will need to change the resource id number in
  79. the "Set Project Type╔" menu item of the Think C 5.0 "Project" menu and recompile.
  80.  
  81. ==================================================================================
  82. ======                        L E G A L  S T U F F                            ======
  83. ==================================================================================
  84.  
  85.  
  86. License:
  87. ========
  88. This software was developed and is copyrighted by  Mark M. Owen, DBA Micro System
  89. Options, and is licensed to you on a non-exclusive basis.  The software may not be
  90. copied in whole or in part except as follows:
  91.  
  92.     (1) You have the right to include the object code produced by the software in 
  93. programs that you develop and you also have the right to use, distribute and license 
  94. such programs to third parties without payment of any further license fees providing 
  95. that the copyright notice below is included in the "about box" of your software, in 
  96. the documentation for it, and on the labels affixed to the media on which your 
  97. software is distributed.  
  98.  
  99.     (2)    You may distribute copies of the complete archive to others provided that
  100. the archive file contains ALL of the original files including this document.
  101.  
  102. Copyright ⌐1991 Mark M. Owen. Portions of this product are copyrighted by Mark M. Owen.
  103.  
  104.  
  105. Warranty:
  106. =========
  107. THERE ARE NO WARRANTIES TO YOU OR ANY OTHER PERSON OR ENTITY FOR THIS SOFTWARE
  108. EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF
  109. MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE, ALL SUCH WARRANTIES ARE
  110. EXPRESSLY AND SPECIFICALLY DISCLAIMED.
  111.  
  112. Some states do not allow the exclusion of implied warranties or limitation on
  113. how long they last, so the above limitation and exclusion may not apply to you.
  114. This limited warranty gives you specific legal rights and you may also have 
  115. other rights which vary from state to state.
  116.  
  117. IN NO EVENT SHALL MICRO SYSTEM OPTIONS BE RESPONSIBLE FOR ANY DIRECT, SPECIAL,
  118. INCIDENTAL, CONSEQUENTIAL, OR SIMILAR DAMAGES OR LOST DATA OR PROFITS TO YOU 
  119. OR ANY OTHER PERSON OR ENTITY REGARDLESS OF THE LEGAL THEORY, EVEN IF WE HAVE 
  120. BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.  
  121.  
  122. Some states do not allow the exclusion or limitation of incidental or 
  123. consequential damages, so the above limitation may not apply to you.  The
  124. warranty and remedies set forth are exclusive and in lieu of all others, oral
  125. or written, express or implied.
  126.  
  127. =====================================================================================
  128.